============================================================================
               CNet WHO's, v2.66 from Frontiers BBS! by Dotoran
============================================================================

What Is It?
~~~~~~~~~~~
    This is the WHO replacement package you've been waiting for! Especially
if you're a multi-line SysOp, as these are the FIRST EVER external WHO files
that EXACTLY MIMIC CNet's WHO commands in ALL ways, including HIDDEN users!

    You will find three versions of the WHO command, each with it's own list
of features:

"Short Who" - The "W" Command:
 ~~~~~~~~~         ~
    - Port Number (Scans ALL Loaded Ports. Will only display IDLE ports if
                   you have this enabled through CNet's CONFIG program!)
    - User's Handle
    - Where the User IS in your System!
    - Conference Control Flag (+) Supported 100%. (This means that users on
      other ports who try to Hide or Muffle a Conf. Controller will appear
      to do so on THEIR screens, but will FAIL to do so on the Controller's
      WHO screen, just like CNET!)
    - Hiding "h", and Muffling "m" fully supported.
    - Attempted Hiding "H", and Attempted Muffling "M" also supported!
      (This is what a Conference Controller will see on their WHO screens
       of user's who are trying to Hide or Muffle them!)
    - SuperUser Flag "S" now shown as well. Users with the "SuperUser" flag
      will have added abilities on the "Internet" side of things, once CNet
      has these features more solidly in place. (Presently, the flag is NOT
      being used yet).
    - Idle Ports now have the ability to show how LONG they've been Idle,
      provided you have "Show Idle Ports" set in CONFIG!
    - Occupied Ports that have been IDLE for LONGER than 5 minutes now tell
      you this, so that you can get an idea as to whether or not the user
      on the port is REALLY there or not!
    - Fully colorized, with two separate HELP menus for beginning users!


"Normal Who" - The "WH" Command:
 ~~~~~~~~~~         ~~
    - Contains everything the "Short" format does, PLUS:
    - Logon Time.
    - Current CPS Rate (Baud/100).
    - City, State, and Country User Hails From.
    - User's Short, Internal CNet WHO Banner!
    - Idle Ports can now use an optional IDLE Banner, a line of up to 54
      characters that could possibly tell such info as phone numbers, baud
      rates, times, etc. If an Idle Banner is NOT created, the user will be
      shown the regular "<No One>  0  Idle" line instead, unless a DEFAULT
      Idle Banner has also been created.


"Long Who" - The "WHO" Command:
 ~~~~~~~~         ~~~
    - Contains all "Short" and "Normal" information, PLUS:
    - Last Call Date.
    - Gender of User (Male or Female)[Color Coded Blue or Red]
    - Time Used Online TODAY (in Minutes)
    - The User's 3-Line "Glimpse" file.
    - A History Flag "*" Telling which Users Have History Files, which are
      text files of up to 20-Lines!

----------------------------------------------------------------------------
    Of course, all appear in the FRONTIERS BBS Color Scheme, but can easily
be changed by using the included CONFIG file.

    All three versions of the command may also take numeric arguments, which
act just like CNet's built-in versions. These numbers represent the PORTS in
which you wish to scan, like these examples illustrate:

    W 0-2             : Short WHO for Ports 0 thru 2.
    WH 1 4 10         : Normal WHO for Ports 1, 4, and 10.
    WHO 0-2,5.9 12-   : Long WHO for Ports 0 thru 2, 5, 9, and all Ports
                        from 12 thru your Highest Loaded Port.

    Note that ALL forms of arguments are allowed:  2  0,3  1-4,  2.5.8, etc.

    Provided the user has the "Conference Control" flag set in their account,
they may also specify the <C>onfig argument to load the CONFIG file:

    W C     : Load CONFIG, ready to Edit Short Who data.
    WH C    : Load CONFIG, ready to Edit Normal Who data.
    WHO C   : Load CONFIG, ready to Edit Long Who Data.
              This version also allows for ALL Versions to be Created.

    You can type as much of the word CONFIG as you wish, but only the first
letter will be looked at, so the following would also load the CONFIG:

    W CONFIG
    WH CON
    WHO C

    Also, when using the "Long" Who version, there are four more arguments
that can be used to SKIP the WHO Listing and immediately enter one of the
Long Who prompt commands. Again, you may type as MUCH of the keyword as you
wish, but only the first letter is required:

    WHO B   (or WHO BANNERS, etc.) to edit/pick a Short Who Banner!
    WHO G   (or WHO GLIMPSE, etc.) to edit their Glimpse File!
    WHO H   (or WHO HISTORY, etc.) to edit their History File!
    WHO V   (or WHO VIEW, etc.)    to edit their History File also!

    In addition, these NEW arguments have been added into v2.1c. Two are for
Conference Controllers ONLY, and the other two are for ALL users:

    Conference Controllers ONLY:
  ================================

    WHO I   (or WHO IDLES, etc.)   to ReLoad your Idle Who Banners!

    WHO E   (or WHO EDIT, etc.)    to Modify your Idle Who Banners!

        - The editor is entered, giving you 102 lines. This is to allow for
          100 lines of regular ports, 1 line for a default banner, and 1
          line for the Total Banners on file.

    Available to ALL Your Users:
  ================================

    WHO P   (or WHO PORT, etc.)    to display CURRENT PORT's Idle Banner.

        - This comes in handy when a user wishes to know which phone number
          they happened to call in on, etc.

    WHO Q   (or WHO QUICK, etc.)   to QUICK display the "Long" output.

        - "Quick" display will suppress the printing of Glimpses, lines of
          separator characters BETWEEN each port, as well as any HELP MENUS
          that may need to be printed, and finally the options prompt. What
          is RETAINED is the Last Call Date, User Gender, History Flag and
          Total Time Online Today, which is NOT shown in the "Normal" file.

    Lastly, all WHO's should be able to be aborted by pressing ANY key while
they are displaying, without having to wait for the ENTIRE listing to be
shown.


How Do I Install It?
~~~~~~~~~~~~~~~~~~~~
1: Copy the "Who/" directory somewhere on your system, preferably somewhere
   in your DOORS: assigned area. It doesn't matter WHERE you copy this Who/
   directory, however make sure you leave ALL FILES TOGETHER inside of this
   directory. Remember the path you placed this directory, and use it when
   you see the <path> designations below.

2: Load your BBSMENU text file, found in the CNET: path, into any text editor
   and make the following changes:

        A: Locate Menu # 2, Available Everywhere Menu, and find the entry
           line containing the text "WHo" and place a "2" in FRONT of this
           text, so that the text now reads "2WHo" (minus the quotes).

        B: At the BOTTOM of this Menu, add the following three lines:

                WHO    `1- | {#0<path>Who/Long}
                WHo    `1- | {#0<path>Who/Normal}
                Who    `1- | {#0<path>Who/Short}
                             |
                             `---> A Control-Q character.

          NOTE1: The CAPITALIZATION of the word "WHO" is VERY important in
                 these three lines. The W, H, and O should ALL be UPPERCASE
                 in the FIRST line, while only the W and H in the SECOND
                 line, and ONLY the W in the THIRD line.

          NOTE2: Change the <path> above to the one you used in Step # 1.

        C: Since CNet's built-in WHO command looks almost IDENTICAL to MY
           "Normal WHo" version, I choose to use CNet's version instead of
           mine. I do this, mainly for speeds sake. To make YOUR System use
           CNet's WHO for the SECOND version, change the SECOND line above,
           so that it reads like this:

                WHo    `1- | {& 2WHo}
                             |
                             `---> A Control-Q character.

          NOTE1: The "2WHo" text, inside the {& } command, should appear the
                 EXACT same as it appears in the BBSMENU file, as you changed
                 it in step "A" above. That is, only the "W" and "H" should be
                 capitalized.

          NOTE2: I use a "2" in front of the internal WHo command, instead
                 of one of those oddball looking ALT-Graphic characters,
                 because remote users can NOT produce these characters in
                 their terminal programs, so would be UNABLE to invoke the
                 "old" usage of this(or any other) "set aside" commands.

        D: Starting with v2.64 of CNet Who, you can now additionally create
           numerous OTHER commands by specifying an argument in the BBSMENU
           line, using the LONG module, as these examples illustrate:

                WQ, Who Quick   `1- | {#0<path>Who/Long Q}
                WB, Who Banners `1- | {#0<path>Who/Long B}
                WP, Which Phone `1- | {#0<path>Who/Long P}
                WG, Who Glimpse `1- | {#0<path>Who/Long G}
                WH, Who History `1- | {#0<path>Who/Long H}
                                      |
                                      `-- Control-Q characters.

3: Locate the "Write" command in the following Menus:

            4; The new Message/File Area menu
            5; Respond or Pass?
            17; Mail
            20; Browse

   You must change the TEXT of this command, so that it reads:

            WRite       instead of      Write
             |
             `---> Make this "R" UPPERCASE.

   This is a needed change, because unless you make this change, the WRITE
   command will NOT function in these areas if the user types "W" to change
   the description of a file, or enter the editor with the current mail
   message(They'll be shown the SHORT WHO instead!)

4: You will also want to update the following HELP files, which can be
   found inside your "SysText:Help/" directory to reflect the change you
   made in Step # 3:

            mail   - Goes with Menu # 4 & 5
            post   - Goes with Menu # 17 & 20

    I checked the "browse" help file, but noticed the WRITE command was not
    included in that file, so no changes are needed to that file. To make
    the change, the line in question starts with:

            \c7W\c6rite ...etc.

    Change it, so it looks like this:

            \c7WR\c6ite ...etc.
            |    |
            `----`---> Remember, these are Control-Y characters!

5: Load your BBSTEXT file into a text editor, then go to line 62 of that
   file. It looks like this(in a stock 4.21 bbstext):

            \n1@ Cleared for logon\n1
            |                     |
            `---- Control-Y's ----'

   To the end of this line, add the following:

            {#0<path>Who/Loader}
            ^
            Control-Q

   This will insure that the IdlePort Banners are loaded, as well as
   updating the user's multiple who banners(if allowed).

6: Edit the "IdlePorts" text file, included inside the "Who/" directory to
   contain the Idle Banners you wish to use. The format of the file is
   fairly loose:

        Line 1: Should contain a number, followed by at LEAST one SPACE,
                then any other text you wish. This NUMBER is the total
                number of lines BELOW that will be read into the computer
                the FIRST time someone logs onto the bbs AFTER this mod
                has been installed.

      Line 2-?: a|b
                ||`--> Idle Banner Text.
                |`---> Pipe (Vertical Bar) [To Right of Equals Sign]
                `----> The Port Number.

                eg: 1|Line # 1, SupraFAX 28.8 (716)/823-9892

             NOTE1: The port numbers do NOT have to come in ORDER in the
                    file. Use whichever order best suits your need!

             NOTE2: Starting the line with a "D" (minus the quotes), instead
                    of a Port Number will define the DEFAULT Idle Banner to
                    use for any ports that may be loaded, but that do NOT
                    contain a premade Idle Banner.

7: That's it! You're Done! You can RELOAD your BBSMENU and BBSTEXT files by
   using the RAMIGA-T key combination(while CNet's Control Panel is active)!

How to Enable/Disable the `SuperUser' Privilege Flag
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   When the `SuperUser' flag was first introduced in CNet, v4.xx, it was
automatically ENABLED in every user's account.

   When fully implemented, this new flag will carry a similar function as
that of the `System Operator' flag, except that this flag will determine
if a user will have `root access' powers to the Internet applets which are
coming to CNet Amiga in the very near future. Things like being able to
finger ANYONE, being able to work with ANY file in ANY directory using the
FTP commands, being automatically given "op" status in the IRC client, etc.

   So, knowing this, chances are this is NOT a flag you'll want to give to
ALL of your users. Here's how you can DISABLE the new `SuperUser' flag in
the user accounts on YOUR bbs's, using CNet's own EA VDE Editor:

1. Logon to your bbs, then type the following from the main command prompt:

        EA 1-       (So that you can edit ALL accounts)

2. You'll then be asked which access groups you wish the changes to be made
   to. Enter the range of groups you wish to DISABLE the flag in, perhaps:

        0-30        (So only Group 31's would HAVE the flag enabled)

3. You'll then be presented with the EA VDE screen, but will note that ALL
   the entries are ghosted(in black). Move to the second column and select
   the "Privilege flags    >>" option.

4. Once on the "Privileges" screen, go to the LAST item in the third column,
   "SuperUser      :", then press your ENTER key until you see the word "No"
   appear.

5. Move to the "Exit" option, press ENTER, then press ENTER while the "Save
   changes" option is highlighted.

6. That's It! Now just sit back and let CNet do the rest!

   How LONG the operation will take will depend on the number of accounts
you have, as well as your CPU type. (On my A=2000, with over 400 accounts,
it took close to a minute to complete the operation).

   Once complete, you'll notice an "S" following the Port Number in the WHO
displays(both MINE and in CNet's internal version). This "S" flag Supersedes
all other displays that could appear here.

What's This LONG WHO Command Menu?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    Well, let's look at the command menu that appears BELOW the Long WHO's
listing:

            Long Who [B]anner, [G]limpse, [V]iew History, or [QUIT]:

    From the above command menu, four commands are possible:

"[B]anner"

    - Allows the user to, then and there, edit the contents of their current
      short CNet WHO Banner. (The same one available for editing via EP;14).
      Their existing WHO Banner is displayed for the user as the default, so
      they can make either small changes, or simply delete the whole thing
      and start it over again.

    - The user is also allowed to enter MCI-Color Codes into their short
      WHO Banner, using Control-Y type MCI codes.

            - NOTE: See the info below dealing with TOGGLE settings for more
                    info on how you wish MCI's supported in the Who Banners.

    - They can also use the following SPECIAL Key-Strokes for editing:

            - CONTROL-X : Deletes EVERYTHING in the string gadget.
            - CONTROL-B : Move Cursor to the Beginning of the string.
            - CONTROL-N : Move Cursor to the eNd of the string.
            - BACKSPACE : Delete character to LEFT of cursor, then move the
                          cursor INTO that position.
            - DELETE    : Will PULL text to the RIGHT of the cursor INTO the
                          cursor, deleting characters as it goes.

    - For v2.0, this section received a bit more power, because NOW when the
      user presses "B", they are taken to a NEW screen that allows them to
      create MULTIPLE Short WHO Banners, up to TEN in all. They may choose
      to EDIT any of them, using the techniques above, and can even swap the
      "Current" Banner their using, in which case the NEW Banner would also
      be permanently written to their user account(thus editable via EP;14).

    - You may disable this feature through the CONFIG file.

    - The user's Short Who Banners are stored in a file called "_Banners",
      which is stored in the user's uucp mail directory inside the cnet
      "mail:users/" directory.

    - For v2.1, the Loader was modified to perform a "Pick Banner" operation
      whenever the user signs onto your board, PROVIDED a "Banners" file is
      found for that user. This way, if they are using multiple different
      banners, each call will activate a NEW banner for them, without the
      user having to do it manually via "WHO B;P".

"[G]limpse"

    - The "Glimpse" files are three 78-character lines, EXCLUDING the Short
      WHO Banner, that the user may create listing more info they want other
      users to know about. These "Glimpse"'s are shown on the LONG version
      who screen only.

    - The user is given the FULL POWER of the CNet Amiga Text Editor to enter
      whatever they wish for their 3-Line "Glimpse" file. Use of ANY MCI's
      the user has access to is fully supported.

    - If a user wishes to DELETE a "Glimpse" file, they should first enter
      the editor with it, then DELETE it from the editor, using the .N
      command, then SAVE the EMPTY editor. They will THEN be given a prompt
      asking if they wish to DELETE the "Glimpse" file on disk.

    - The Glimpse file is stored as "_Glimpse" in the user's uucp directory,
      in the same way the banners are.

    - If a user does not have a "_Glimpse" file created in their uucp mail
      directory, then the default glimpse file will be displayed when the
      LONG who version is used, however this default file is NOT stored in
      the user's uucp directory, but exists as "<path>Who/_Glimpse".

"[H]istory"

    - You'll be given another command prompt when this command is used:

            [E]dit, [V]iew by Port, or [S]pecific Histories? [QUIT]:

    - If you choose to "[E]dit" your History file, any existing History will
      be loaded into the CNet Editor, and you'll be given 20-Lines to enter
      anything you'd like. The same editor features as the "Glimpses" are
      allowed for use with "History" files.

    - If a user wishes to DELETE a "History" file, they should first enter
      the editor with it, then DELETE it from the editor, using the .N
      command, then SAVE the EMPTY editor. They will THEN be given a prompt
      asking if they wish to DELETE the "History" file on disk.

    - Pressing "[V]iew by Port" allows the user to view the History of a
      user signed onto another port. Checks are made to insure their IS a
      user on that port, and that the port is LOADED.

    - If you choose "[S]pecific Histories", you'll be asked to enter either
      the ID Number, Handle, or Real Name of the user to view the History of.
      If an incomplete Real Name or Handle is entered, you'll be shown the
      User List menu, and can then choose the proper name off the menu. It is
      possible to view your OWN History file by supplying your OWN info here.

    - Pressing ENTER/RETURN, or pressing "[Q]uit" will take you back to the
      initial command prompt.

    - The History file is stored as "_History" in the user's uucp directory,
      in the same way the banners are.

    - If a user does not have a "_History" file created in their uucp mail
      directory, then the default history file will be displayed when the
      LONG who version is used, however this default file is NOT stored in
      the user's uucp directory, but exists as "<path>Who/_History".

"[QUIT]"

    - Pressing ENTER/RETURN, or pressing "[Q]uit" will exit the Long Who,
      and return you to the CNet Command Prompt that called WHO.

How do I use the CONFIG File?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    One of the NEW features of v2.0 is the addition of an ANSI-ARexx style
CONFIG program, written to mimic the VDE-type editors you may have seen and
used with CNet before.

    You should enter the CONFIG program thru one of the WHO programs. Which
WHO program you use to launch the CONFIG will have a bearing on which data
items you will be able to edit on the various screens within the editor. For
instance, things like Who Banners, Idle Port Banners, Glimpse Files, etc are
not used in the SHORT form WHO program, so will appear as ghosted(black) on
the CONFIG screen, and will not editable.

    As mentioned above, use one of the following three commands to load the
CONFIG:
            W C     : Enter CONFIG to edit Short Who data.
            WH C    : Enter CONFIG to edit Normal Who data.
            WHO C   : Enter CONFIG to edit Long Who data.

    You can also add the CONFIG file into your DOORS area as an Exclusive
Use Only ARexx Pfile. You must specify an argument of W, WH, or WHO, so that
the CONFIG will know WHICH WHO you wish to edit. Specify WHO if you wish to
edit ALL of them at the same time. If the argument is NOT specified, the
CONFIG file will exit, shortly after loading.

        NOTE: SysOps running a 4.xx version of CNet may have noticed that
              when adding an ARexx Door, the "Arguments" field is not given
              on the VDE screen, however you CAN give arguments. You simply
              include a SPACE after the <path>Who/Config line, THEN include
              your W, WH, or WHO argument text.

    Alright, you know HOW to load the CONFIG, now here's some info pertaining
to certain things within the CONFIG that may need additional clarification:

Text String Gadgets:
~~~~~~~~~~~~~~~~~~~~
    All text string gadgets may use the following SPECIAL key-strokes to aid
in the entering/editing of text:

    CONTROL-X : Erase Everything.
    CONTROL-B : Move to Beginning of Text.
    CONTROL-N : Move to End of Text.
    BACKSPACE : Delete Character to LEFT of Cursor.
       DELETE : Pull Character to RIGHT of Cursor INTO the Cursor.

    In addition, each string gadget is formatted for the MAXIMIMUM allowed
length that can be used in the Layout.

"BG"
 ~~
    Means a BackGround Color, and can be any of the following characters,
which correspond to the equivalent MCI-Z Color Codes:

            0, 1, 2, 3, 4, 5, 6, and 7.

"FG"
 ~~
    Means a ForeGround Color, and can be any of the following characters,
which correspond to the equivalent MCI-C Color Codes:

            0, 1, 2, 3, 4, 5, 6, 7, 8, 9, a, b, c, d, e, and f.

Use of BG and FG:
~~~~~~~~~~~~~~~~~
    These fields use 1 character string gadgets. After pressing ENTER, you
can do one of two things:

    1: Type a NEW value, which will then REPLACE the old value. Press ENTER
       to confirm your choice, or use the BACKSPACE key to delete and try
       again.

    2: Press ENTER again, in which case the NEXT value in sequence will be
       used, so if the value WAS "a", it would become a "b". If the value
       was "f", it would turn over and become a "0". A "3" would become a
       "4", etc.

Use CNet "Stock" BBS
Use "Frontiers"  BBS
~~~~~~~~~~~~~~~~~~~~
    These two items allow you to select two built-in default settings. The
"Stock" version is a rather plain looking color combination, while "Frontiers"
is the familiar blue scenario that previous versions have used.

Saving Changes Made?
~~~~~~~~~~~~~~~~~~~~
    The CONFIG uses a "Smart Save" feature, just like CNet's VDE Editors, so
if all you do is load the CONFIG and LOOK at some values, when you select
the "<< Exit" option, you will immediately exit the file, but if changes
have been made, you'll get another screen asking if you'd like to SAVE the
changes you've made.

ReLoad "IdlePorts"
~~~~~~~~~~~~~~~~~~
    If you've made changes to the "IdlePorts" text file, you'll need to
ReLoad them into memory, so that the NORMAL and LONG Who versions will
reflect these changes.

    After selecting this option, a second or two will go by, then the screen
should flash and you may hear a beep sound, which alerts you the process has
completed.

    NOTE: Remember, as of v2.1c, you can now use "WHO I" to ReLoad the Idle
          Port Banners as well.

CREATE SHORT WHO
CREATE NORMAL WHO
CREATE LONG WHO
CREATE ALL WHO FILES
~~~~~~~~~~~~~~~~~~~~
    Simply SAVING your changes is NOT all you have to do in order to BIND
the changes you've done. When you're satisfied with the color/text choices
you've made(use Show Example LayOuts), then you are ready to CREATE the WHO
file.

    You have the option of creating a unique look for EACH of your WHO's, or
you can use the "ALL WHO FILES" (only available in the LONG Who CONFIG) to
use the Long Who settings to create ALL THREE versions.

    The CONFIG file actually GENERATES CUSTOM AREXX CODE containing the data
you entered in the CONFIG program. This way, the WHO files execute a LOT
faster than they would if they had to constantly read in a config file, set
up a bunch of variables, then slap the variables into place.

    It also allows you to easily be able to EDIT any of the WHO files, if
you find there are some small changes you'd like to make in ADDITION to
those made by the CONFIG, however you need to follow this warning:

***WARNING***
=============

    Treat the "Short", "Normal", and "Long" text files the same way you would
treat the BBSTEXT file, in that you should NOT alter the ORDER of the lines
within each of these files.

    The "MakeWho" program is written to read in all the lines from each of
these files, then REPLACE certain lines with those containing your CUSTOM
values. ALTERING THE ORDER OR SEQUENCE of any of these files will result in
CATASTROPHIC EVENTS! The "MakeWho" program may NOT be loaded externally by
you through the Doors section. The CONFIG program MUST be the one that is
used to call this file. (In other words, LEAVE THIS FILE ALONE!)

    Also, UNLIKE the BBSTEXT file, you should NOT alter the CONTENTS of any
of the lines IF you think you'll be using the MAKEWHO program again, as any
changes you make to the actual code MAY not be recreated by the MAKEWHO file,
if the changed line contains an MCI-Color Code. If you note a problem in one
of the lines, please alert me of the fact, so that I can take the proper
steps to edit the MAKEWHO file to also correct the problem when you generate
a NEW who format.

    After selecting this option, a few seconds will go by, then the screen
should flash and you may hear a beep sound, which alerts you the process has
completed.

Info On Toggle Switches:
~~~~~~~~~~~~~~~~~~~~~~~~
    Show Idle Minutes
    ~~~~~~~~~~~~~~~~~
        Yes : Displays "Idle 2h 10m 7s" in the WHERE Column.
        No  : Displays "Idle"           in the WHERE Column.

        NOTE: In v2.64, the format of this string changed to show the hours,
              minutes, and seconds of Idle Time present. Using another new
              toggle value below, you can also display DAYS of idle time.

    Show Idle Banners
    ~~~~~~~~~~~~~~~~~
        Yes : Displays "IdlePortB?" line, if it exists.
        No  : Displays "<no one>        0"  CNet's Default.

    Multiple Banners
    ~~~~~~~~~~~~~~~~
        Yes : Allow User to Use/Edit Multiple Short Who Banners.
        No  : Disable this feature. User will have to resort to EP;14.

    Skip Idle Ports
    ~~~~~~~~~~~~~~~
        Yes : Will NOT print Port Info if it's an Idle(Empty) Port.
        No  : Display Idle Port Info.

    Skip Hidden Ports
    ~~~~~~~~~~~~~~~~~
        Yes : Will NOT print Port Info if User On that Port is HIDING.
        No  : Will display this port as "appearing to be Idle".

        NOTE: When set to "No", CNet WHO uses an interesting trick to show
              the number of minutes the port has been idle. The value used
              here is actually the total number of minutes the CURRENT user
              has been online(added to a FAKE Idle Time; discussed below).

    Allow Banner MCI's
    ~~~~~~~~~~~~~~~~~~
        Yes : Allow the user to use MCI commands while creating Who Banners.
        No  : Do NOT allow MCI's to be input into the Who Banners.

        NOTE: If this option is set to YES, but the user does not have the
              ACCESS to use MCI's, then any MCI's entered by the user will
              be automatically STRIPPED from the string. Also, if the user
              has MCI-1 Access, but NOT MCI-2 Access, the MCI-2 Level MCI
              codes will be STRIPPED if found.

    Allow SysOp  MCI's
    ~~~~~~~~~~~~~~~~~~
        Yes : Allow System Operators to use SYSOP-ONLY MCI's in Banners.
        No  : SYSOP-ONLY MCI commands will be STRIPPED from Who Banners.

        NOTE: A "System Operator" is a user who has this priviledge flag
              set in their user accounts. Lines 4 and 5 in your BBSTEXT file
              determine which commands to deem SYSOP-ONLY(Line 4) and as
              Level 2 MCI's(Line 5). Any commands NOT FOUND on these two
              lines are available to users with Level 1 MCI Access. These
              two lines are automatically read into the CONFIG program each
              time it is used, so as to insure the proper stripping is done.

    Clear Screen Before
    ~~~~~~~~~~~~~~~~~~~
        Yes : The Screen is CLEARED BEFORE the WHO info is shown.
        No  : The Screen is NOT cleared before the info is shown.

    Use Empty Port Block
    ~~~~~~~~~~~~~~~~~~~~
        Yes : Use following values to SPEED up the printing.
        No  : Follow normal "1x1" iteration method.

    Port to Skip FROM
    ~~~~~~~~~~~~~~~~~
        When this port value is reached in the loop, the loop will then
        IMMEDIATELY jump to the following value.

    Port to Skip TO
    ~~~~~~~~~~~~~~~
        The value to RESUME scanning for Port data. For instance, with these
        ports set up:  0, 1, 2, 3, 98, and 99, you'd want to specify a "3"
        in the FROM field, and "98" in the TO field, so that the who isn't
        having to scan: 4, 5, 6, 7, 8, 9, 10, etc. etc. etc. up to 98!

    Print IdleTime Days
    ~~~~~~~~~~~~~~~~~~~
        Provided you have "Show Idle Minutes" enabled, specifying YES to
        this value returns an Idle Time in the format: ?d?h ?m ?s

        If set to NO, then the format used looks like: ?h ?m ?s

    Min. Fake Idle Mins.
    Max. Fake Idle Mins.
    ~~~~~~~~~~~~~~~~~~~~
        These values were included as a means of making HIDDEN USERS appear
        to be hidden MORE SO over previous versions. Because these WHO
        programs have the ability to specify how LONG a port has been IDLE,
        I needed a way to fake idle time on HIDDEN ports. Earlier versions
        had me just snagging the number of minutes the CURRENT user was
        ONLINE and using that value, however I discovered that if a user
        initially logs on, then immediately uses a WHO module, they'd see
        these HIDDEN ports as being Idle for 0-1 Minutes, which made it look
        like these ports logged OFF as soon as this user logged ON, so that's
        where these values come in. You specify a lower and upper limit to
        a range of values, to which one value is randomly selected and then
        ADDED TO the current user's time online. It's this SUM that is used
        for the IDLE TIME for HIDDEN PORTS.

Manual Toggle Setting:
~~~~~~~~~~~~~~~~~~~~~~
    It is also possible to MANUALLY set these toggles in each program by
editing the given line in each version:

                          Line
                         ======
                    Short: 14
                   Normal: 15
                     Long: 24

    Use values of "1" to represent YES, and "0" to represent NO in these
variables, located on the above lines. If a version doesn't contain the
given variable, then that version doesn't use/support that feature.

                        Variable    Toggle It Effects
                        ========    ====================
                           v1       Show Idle Minutes
                           v2       Show Idle Banners
                           v3       Multiple Banners
                           v4       Skip Idle Ports
                           v5       Skip Hidden Ports
                           v6       Empty Port Block
                           loS      Port to Skip FROM
                           hiS      Port to Skip TO (Use hiSk in LONG)
                           v7       Clear Screen Before
                           v8       Allow MCI's in Who Banners?
                           v9       Allow SysOp's to use SysOp-MCI's?
                           v10      Show IdleTime Days

    Remember, ALL VARIABLES MUST RESIDE ON THE SAME LINE, as noted in the
table above. Do NOT place them on individual lines, unless you plan on NOT
using the CONFIG program to CREATE new layouts.

Is That It?
~~~~~~~~~~~
    So far as I can tell, YES! I believe I've covered all the bases. I still
have not been able to locate that ETA line used with File Transfers. I've
been able to deduce that the ETA value is calculated "on the fly" as it's
needed, which makes recreating this value a tough chore, as there are many
getusers involved in calculating this value, MOST of which are accessable
with known getusers, however the one key value I can't seem to locate is
how MANY KILOBYTES have ALREADY been DOWNLOADED(or UPLOADED). Without this
value, coming up with a "ball-park" ETA value is not obtainable.

    If you notice ANY, and I mean ANY problems with this version, PLEASE get
in touch with me, either on Frontiers, The Metal Shoppe, thru Fido-Net Mail
to "David Weeks@1:260/121", CLink-Net Mail to "David Weeks@911:6840/2.0",
or on the InterNet via "dotoran@bluemoon.net".

    There WILL be at least ONE more major release, but I can't put a date as
to when you'll be seeing it, as I've got to start on it again from scratch!

    Enjoy this work! I put some serious work into it!
                                                                  - Dotoran

In The Future?
~~~~~~~~~~~~~~
    CNet WHO, v3.0 will be a complete rewrite, from the ground up, so that I
can also include a custom DATA LAYOUT screen. What this means is you'll then
be able to "pick and choose" exactly WHICH info you wish to show in each of
your three WHO formats. Here's an ASCII shot of the screen layout I'm working
on right now. This is still pretty sketchy, but you'll get the idea:

---snip starts here---

                               Line 1
-A B -C------------------ -J-------------

<---10---><---20---><---30---><---40---><---50---><---60---><---70---><--78-->

Port Number              Minimum Width: 2   Maximum Width: 4   Centered: Yes
Width: 2   Text Bar: >P#<
ForeGround: 4  BackGround: 6  Reversed: No   Underlined: No   BoldFaced: No

  *[A]*Port Number      [M] Last Call Date           [Y] Country Text
   [B] Hide/Muffle Flag [N] Time Used Today          [Z] History Flag
   [C] User Handle      [O] Primary Underscore       [1] Calls By This User
   [D] User Real Name   [P] Secondary Underscore     [2] Balance Owing
   [E] Logon Time       [Q] Total PFile Game Points  [3] Short Who Banner
   [F] Logoff Time      [R] Access Group Number      [4] Glimpse File
   [G] CPS Rate         [S] Access Group Name        [5] User ID Number
   [H] Baud Rate        [T] Total Public Messages    [6] User SID Number
   [I] City Text        [U] Total Uploaded Files     [7] Total File Credits
   [J] Where Location   [V] Total Uploaded Bytes     [8] Total Byte Credits
   [K] Gender Text      [W] Total Downloaded Files   [9] State Text
   [L] Line Width       [X] Total Downloaded Bytes   [0] First Name

---snip ends here---

    As you can see, I'm playing around with allowing you to pick from up to
36 different pieces of information. You can create WHO Layouts of up to 4
lines each, where each line can contain ANY info you wish, in ANY order you
wish, etc. I'm also playing around with the idea of attaching Access Group
restrictions onto each data item, so that the data will only be shown to the
user if their Access Group is high enough. If it's not, they'll just be shown
some dead space in place of the info, or maybe I'll mask out the info. Not
sure yet. I'm also playing around with the idea of creating custom TERMINAL
versions for each file, so you can have ASCII, ANSI, and IBM-ANSI versions
of the WHO files too.

    It's still in the planning stages right now, so if you have anything to
ADD to these initial ideas, PLEASE forward them directly to me for inclusion
into the next version!
                                                                   - Dotoran
============================================================================
                        Frontiers BBS (716)/823-9892!
============================================================================
